Document the need to refilter if parameters of the visibility function

2005-03-29  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_visible_func):
	Document the need to refilter if parameters of the visibility function
	change.  (#169516, Olivier Sessink)

diff --git a/ChangeLog b/ChangeLog
index 7150b15ff5bd319d87679c06aa282817b723f7e4..06fafe0b19c9233526ba8a3da140a32bddd2b105 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2005-03-29  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_visible_func): 
+       Document the need to refilter if parameters of the visibility function
+       change.  (#169516, Olivier Sessink)     
+
 Mon Mar 28 15:13:42 2005  Søren Sandmann  <sandmann@redhat.com>
 
        * gdk/gdkwindow.c (gdk_window_invalidate_maybe_recurse): Don't

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 7150b15ff5bd319d87679c06aa282817b723f7e4..06fafe0b19c9233526ba8a3da140a32bddd2b105 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,9 @@
+2005-03-29  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_visible_func): 
+       Document the need to refilter if parameters of the visibility function
+       change.  (#169516, Olivier Sessink)     
+
 Mon Mar 28 15:13:42 2005  Søren Sandmann  <sandmann@redhat.com>
 
        * gdk/gdkwindow.c (gdk_window_invalidate_maybe_recurse): Don't

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 7150b15ff5bd319d87679c06aa282817b723f7e4..06fafe0b19c9233526ba8a3da140a32bddd2b105 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,9 @@
+2005-03-29  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_visible_func): 
+       Document the need to refilter if parameters of the visibility function
+       change.  (#169516, Olivier Sessink)     
+
 Mon Mar 28 15:13:42 2005  Søren Sandmann  <sandmann@redhat.com>
 
        * gdk/gdkwindow.c (gdk_window_invalidate_maybe_recurse): Don't

diff --git a/gtk/gtktreemodelfilter.c b/gtk/gtktreemodelfilter.c
index 96eccfc0526535edb894d2b5508cad763bf293a0..ca68253c2aefc12d50ab6da3084129ec3ec80b19 100644 (file)
--- a/gtk/gtktreemodelfilter.c
+++ b/gtk/gtktreemodelfilter.c
@@ -2458,6 +2458,11 @@ gtk_tree_model_filter_get_model (GtkTreeModelFilter *filter)
  * function should return %TRUE if the given row should be visible and
  * %FALSE otherwise.
  *
+ * If the condition calculated by the function changes over time (e.g. because
+ * it depends on some global parameters), you must call 
+ * gtk_tree_model_filter_refilter() to keep the visibility information of 
+ * the model uptodate.
+ *
  * Since: 2.4
  */
 void